Warn about `file-notify-rm-all-watches' side effects

* doc/lispref/os.texi (File Notifications): Warn about
`file-notify-rm-all-watches' side effects.

diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index 7c7673f9c5cb1d892fe2482068da740e75c2c533..1fbd66458a4c302264434cb91c899320fb21ea36 100644 (file)
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -3233,6 +3233,10 @@ Removes an existing file watch specified by its @var{descriptor}.
 
 @deffn Command file-notify-rm-all-watches
 Removes all existing file notification watches from Emacs.
+
+Use this command with caution, because it could have unexpected side
+effects on packages relying on file watches.  It is intended mainly
+for debugging purposes, or when Emacs has been stalled.
 @end deffn
 
 @defun file-notify-valid-p descriptor